std::basic_istream::ignore

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++0x feature) Atomic operations library (C++0x feature) Thread support library (C++0x feature)
Input/output library
basic_streambuf basic_filebuf basic_stringbuf ios_base basic_ios basic_istream basic_ostream basic_iostream basic_ifstream basic_ofstream basic_fstream basic_istringstream basic_ostringstream basic_stringstream C-style I/O
std::basic_istream
Member functions basic_istream::basic_istream basic_istream::~basic_istream Formatted input basic_istream::operator>> Unformatted input basic_istream::get basic_istream::peek basic_istream::unget basic_istream::putback basic_istream::getline basic_istream::ignore basic_istream::read basic_istream::readsome basic_istream::gcount Positioning basic_istream::tellg basic_istream::seekg Miscellaneous basic_istream::sync Member classes basic_istream::sentry

​basic_istream& ignore();​	(1)
​basic_istream& ignore( pos_type count );​	(2)
​basic_istream& ignore( pos_type count, char_type delim );​	(3)

Extracts and discards characters from the input stream. For all versions if ​good() != true​, ​setstate(failbit)​ is called and the function returns. If end-of-file occurs, ​setstate(eofbit)​ is called and the function returns.

1) ignores and discards one character

2) ignores and discards up to count characters

3) ignores and discards up to count characters. The operation is stopped when delim character is found in which case it is also extracted

Contents 1 Parameters 2 Return value 3 Example 4 See also

Parameters

count	-	number of characters to extract
delim	-	delimiting character to stop the extraction at. It is also extracted.

Return value

​*this​

Example

This section is incomplete

See also

get	extracts characters (public member function)
getline	extracts characters until the given character is found (public member function)